home *** CD-ROM | disk | FTP | other *** search
/ Shareware Super Platinum 8 / Shareware Super Platinum 8.iso / mac / DATABASE / DVER20.ZIP;1 / DVER.MAN < prev    next >
Encoding:
Text File  |  1993-08-05  |  51.3 KB  |  2,047 lines
  1.  
  2.  
  3.  
  4.  
  5.                                        Preface
  6.  
  7.  
  8.         dVERSION is a dBASE text translator.  It was designed to give the
  9.         dBASE programmer a facility to maintain dBASE code.
  10.  
  11.         dVERSION is a program that will conditionally translate dBASE code.
  12.         dVERSION allows the programmer to have many versions of an
  13.         application in one set of source code.  In addition, dVERSION offers
  14.         an INCLUDE facility that can insert code from specified files.
  15.  
  16.         dVERSION is for the serious software developer.  Source code can be
  17.         conditionally translated to many operating systems.  The INCLUDE
  18.         facility provides more efficient use of disk space.
  19.  
  20.         dVERSION will work on most IBM personal computers.  No additional
  21.         hardware is required.
  22.  
  23.         Although considerable effort was expended to make the user reference
  24.         manual as complete as possible, this documentation is in no way to be
  25.         considered an instructive guide to dBASE.  Many reference texts are
  26.         available on the market that explain dBASE programming.  If you are
  27.         learning dBASE, your reference materials should include one of these
  28.         texts.
  29.  
  30.         My advice is to peruse the contents of this reference manual to
  31.         familiarize yourself with its information.  If you are working on
  32.         large projects or projects for more than one operating system,
  33.         concentrate especially on the conditional translating.  You will
  34.         probably need it at one time or another.
  35.  
  36.         If you have any questions concerning this application, feel free to
  37.         write or call.
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                      - Page 1 -
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.                              Copyright/License/Warranty
  72.  
  73.  
  74.  
  75.  
  76.         This document and the program dVERSION ("the software") are
  77.         copyrighted by the author.  The copyright owner hereby licenses you
  78.         to use the software given these restrictions:
  79.  
  80.  
  81.              o  the program shall be supplied in its original, unmodified
  82.                 form, which includes this documentation;
  83.  
  84.              o  for-profit use without a license is prohibited;
  85.  
  86.              o  the program may not be included - or bundled - with other
  87.                 goods or services.  Exceptions may be granted upon written
  88.                 request only.
  89.  
  90.              o  no fee is charged beyond a reasonable amount for the media
  91.                 and handling ($10 maximum suggested);
  92.  
  93.  
  94.              There is no warranty of any kind.  The copyright owner may not
  95.              be held liable for any damages, including any lost profits or
  96.              other incidental or consequential damages arising out of or
  97.              inability to use the software.  By using the software, you agree
  98.              to this.
  99.  
  100.  
  101.         Shareware
  102.  
  103.              dVERSION is distributed as Shareware.  It is not free software.
  104.              You are free to try it and make copies for others.  If you
  105.              continue to use this application beyond a reasonable trial
  106.              period, you are required to register it with the distributor
  107.              and author.
  108.  
  109.  
  110.         ASP Ombudsman
  111.  
  112.              This program is produced by a member of the Association of
  113.              Shareware Professionals (ASP).  ASP wants to make sure that the
  114.              shareware principle works for you.  If you are unable to resolve
  115.              a shareware-related problem with an ASP member by contacting the
  116.              member directly, ASP may be able to help.  The ASP Ombudsman can
  117.              help you resolve a dispute or problem with an ASP member, but
  118.              does not provide technical support for members' products.
  119.  
  120.              Please write to the ASP Ombudsman at 545 Grover Road, Muskegon,
  121.              MI 49442-9427 USA, FAX 616-788-2765 or send a CompuServe message
  122.              via CompuServe Mail to ASP Ombudsman 70007,3536.
  123.  
  124.  
  125.  
  126.              Copyright (C) 1987 Dennis Allen.  All rights reserved.  All
  127.              trademarks mentioned herein belong to their respective owners.
  128.  
  129.                                      - Page 2 -
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.                                   TABLE OF CONTENTS
  138.  
  139.  
  140.         Preface                                                    1
  141.         Copyright/License/Warranty                                 2
  142.         Introduction                                               4
  143.             Manual Content                                         4
  144.             Notation Convention                                    5
  145.         Getting Started                                            6
  146.             Translating dVERSION code                              7
  147.             Conditional Translating                                7
  148.             Remarks                                                8
  149.             INCLUDE\                                               8
  150.         Advanced Techniques                                        9
  151.             Command Line                                          10
  152.             Automated                                             10
  153.         dVERSION Reference Section                                11
  154.             Part I/ dVERSION Commands                             11
  155.                 BLK Command                                       11
  156.                 CLEAR Command                                     12
  157.                 CLS                                               12
  158.                 HELP Command                                      12
  159.                 HLP Command                                       13
  160.                 IN Command                                        13
  161.                 LIST Command                                      14
  162.                 OUT Command                                       14
  163.                 PAR Command                                       14
  164.                 PARMS Command                                     15
  165.                 PMT Command                                       15
  166.                 QUIT Command                                      15
  167.                 REM Command                                       16
  168.                 REMOVE Command                                    16
  169.                 RUN Command                                       16
  170.                 SUF Command                                       17
  171.                 SYSTEM Command                                    17
  172.             Part II/ dVERSION Reserved Words                      18
  173.                 - Conditional Translating -                       18
  174.                 - INCLUDE\ -                                      18
  175.                 - Remarks -                                       19
  176.                 - Macros -                                        19
  177.             Part III/ dVERSION Error Messages                     20
  178.             Part IV/ dVERSION Sample Output                       21
  179.             Appendix A/ Data Files                                26
  180.             Appendix B/ dVERSION Standards                        27
  181.         Glossary                                                  28
  182.         Index                                                     30
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                      - Page 3 -
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.                                     Introduction
  204.  
  205.  
  206.         The purpose of dVERSION is to translate dBASE code, conditional upon
  207.         specified parameters, into executable dBASE code.  It was designed to
  208.         give the programmer a facility to maintain dBASE code.
  209.  
  210.         Before continuing, we should explain a couple of terms.  We mentioned
  211.         earlier the concept of conditional translation.  Conditional
  212.         translation means that only specified portions code will be
  213.         translated into dBASE code.  Conditional translation allows many
  214.         versions of a program to reside in one file.
  215.  
  216.         Source code refers to what a translator reads as input.  In other
  217.         words, the input file.  Output code refers to what a translator
  218.         creates from source code.  In other words, the resulting output file.
  219.  
  220.         This manual assumes that you are already familiar with dBASE terms.
  221.         If not, refer to the Glossary or consult your dBASE reference manual.
  222.  
  223.         The dVERSION manual is divided into three main sections.  The first
  224.         section explains how to get started using the dVERSION.  The second
  225.         section explains how to specify wildcard filenames.  The third
  226.         section is a dVERSION reference.  Each reference section gives
  227.         detailed information on use of commands, code, and will show sample
  228.         output.
  229.  
  230.  
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.                                      - Page 4 -
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.                                     Introduction
  270.  
  271.  
  272.                                 Notation Conventions
  273.  
  274.  
  275.         CAPITAL LETTERS
  276.  
  277.              Capital letters indicates a command.  During command entry, this
  278.              text should be entered exactly as it appears.  Unless specified,
  279.              any command may be in upper or lower-case letters.
  280.  
  281.         lower case
  282.  
  283.              Parameters to commands are usually typed in lower-case
  284.              characters.
  285.  
  286.         Ellipsis "..."
  287.  
  288.              The ellipsis represent repetition of a previous item.
  289.  
  290.         Single Key "[ ]"
  291.  
  292.              The single key command is represented by the characters "[" and
  293.              "]".
  294.  
  295.         Control keys
  296.  
  297.              Control keys are designated with a "[Ctrl]-" followed by the
  298.              name of another key (for example: [Ctrl]-[S]).  To enter a
  299.              control key, press [Ctrl] on your keyboard and, while holding it
  300.              down, press the additional key.  On some Foxpro menus, control
  301.              keys are designated with a "^" followed by the name of another
  302.              key (for example: ^[End] for [Ctrl]-[End]).
  303.  
  304.         Carriage Return
  305.  
  306.              Depending on your keyboard, the same key may be represented by
  307.              different descriptions.  For example, the carriage return may be
  308.              represented as [Enter], [Return], or [Bent arrow symbol].  For
  309.              the most part, this should not be a problem.  Make sure,
  310.              however, that you understand the function of each key so that
  311.              you understand how they appear in this manual.
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.                                      - Page 5 -
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.                                    Getting Started
  336.  
  337.  
  338.         The purpose of this section is to help you get started using
  339.         dVERSION.  To use dVERSION, at the DOS prompt, type:
  340.  
  341.              DVER
  342.  
  343.         and press [Enter].  The first thing you should see is the following:
  344.  
  345.              dVERSION 2.x for MS-DOS
  346.              Copyright (c) 1987 by Dennis Allen
  347.              Portions (C) Copyright
  348.              Microsoft Corp. 1987 - 1993
  349.              All Rights Reserved
  350.  
  351.  
  352.              .
  353.  
  354.         "." is the dVERSION command prompt.  dVERSION is a command oriented
  355.         program.  But do not confuse dVERSION commands with dBASE code.
  356.         dVERSION commands set the parameters necessary to translate dBASE
  357.         code.
  358.  
  359.         dVERSION commands are easy to use.  For instance, to exit dVERSION,
  360.         you would type:
  361.  
  362.  
  363.              QUIT
  364.  
  365.  
  366.         and press [Enter].  If you needed help, you would type:
  367.  
  368.  
  369.              HELP
  370.  
  371.  
  372.         and press [Enter].
  373.  
  374.         The HELP command is provided to allow quick access to dVERSION topics
  375.         listed in the reference section.  For example, to find more
  376.         information on the HELP command you can either look it up in Part I
  377.         of the dVERSION reference section, or type:
  378.  
  379.  
  380.              HELP HELP_CMD
  381.  
  382.  
  383.         and press [Enter].  If you typed "HELP HELP_CMD", a search would be
  384.         made in the file DVER.HLP for the topic HELP_CMD.  If found, all
  385.         information about that topic would be displayed.  For a summary of
  386.         dVERSION help topics type:
  387.  
  388.  
  389.              HELP TOPICS
  390.  
  391.  
  392.  
  393.                                      - Page 6 -
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400.  
  401.                                    Getting Started
  402.  
  403.  
  404.         and press [Enter].
  405.  
  406.  
  407.                               Translating dVERSION code
  408.  
  409.  
  410.         Now let's set the parameters so dVERSION can translate code.  We
  411.         first need to specify the file dVERSION will read as input.  Type:
  412.  
  413.  
  414.              IN SAMPLE.VER
  415.  
  416.  
  417.         and press [Enter].  If no error message appears, it means the input
  418.         file was found, and verified.  If a message does appear, stay calm.
  419.         Most of the time the input file was not found.  Check your spelling
  420.         and try it again.
  421.  
  422.         Next, we need to specify an output file dVERSION will create.  Type:
  423.  
  424.  
  425.              OUT SAMPLE.PRG
  426.  
  427.  
  428.         and press [Enter].
  429.  
  430.  
  431.                                Conditional Translating
  432.  
  433.  
  434.         In the source file "SAMPLE.VER", we have sections of code bounded by
  435.         the dVERSION reserved words IF\, and END\.  These sections of code
  436.         will be translated depending on the PAR command.  In our example we
  437.         will specify that only code, conditional upon the parameter DOS, be
  438.         translated.  At the dVERSION prompt, type:
  439.  
  440.  
  441.              PAR DOS
  442.  
  443.  
  444.         and press [Enter].
  445.  
  446.  
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.  
  458.  
  459.                                      - Page 7 -
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466.  
  467.                                    Getting Started
  468.  
  469.  
  470.                                        Remarks
  471.  
  472.  
  473.         To remove leading spaces in output code, type:
  474.  
  475.  
  476.              BLK ON
  477.  
  478.  
  479.         and press [Enter].  To remove remarks in output code, type:
  480.  
  481.  
  482.              REM ON
  483.  
  484.  
  485.         and press [Enter].
  486.  
  487.         All other dVERSION commands need not be specified since they have
  488.         default values.  So let's check our parameters.  Type IN and press
  489.         [Enter].  IN should be set with "SAMPLE.VER".  If not, retype.  Type
  490.         OUT and press [Enter].  OUT should be set to "SAMPLE.PRG".  Type PAR
  491.         and press [Enter].  PAR should have the parameter "DOS".
  492.  
  493.         We now are ready to translate.  Type RUN and press [Enter].  Assuming
  494.         that no errors occurred either in the typing of commands, or in the
  495.         translating of code, you should have a file named "SAMPLE.PRG".  This
  496.         file should be correctly translated.
  497.  
  498.  
  499.                                       INCLUDE\
  500.  
  501.  
  502.         You will notice in "SAMPLE.PRG" that additional code was inserted.
  503.         If you look at the file "SAMPLE.VER" you will see the dVERSION
  504.         reserved word:
  505.  
  506.  
  507.              INCLUDE\ SAMPLE2.VER
  508.  
  509.  
  510.         This dVERSION reserved word inserted the file "SAMPLE2.VER" into our
  511.         sample output.  This reserved word can be very useful in saving
  512.         repetitive typing and disk space.  If you are finished, type "QUIT"
  513.         and press [Enter] to return to DOS.
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.                                      - Page 8 -
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533.                                  Advanced Techniques
  534.  
  535.  
  536.         The purpose of this section is to show you some of the more advanced
  537.         dVERSION command and techniques.  At the DOS prompt, type:
  538.  
  539.              DVER
  540.  
  541.         and press [Enter].  In our last example, we typed "SAMPLE.VER" for
  542.         the input file.  This time, type:
  543.  
  544.  
  545.              IN *.VER
  546.  
  547.  
  548.         and press [Enter].  This is a wildcard filename.  All files with a
  549.         file extension "VER", will be converted.
  550.  
  551.         In the last example, we typed "SAMPLE.PRG" for the output file name.
  552.         But since dVERSION v2.0, the output file name defaults to "*.PRG".
  553.         This means that any output file will acquire the input file name and
  554.         will have a "PRG" file extension.
  555.  
  556.  
  557.         Example:  If the input file name is "SAMP.VER", the output file name
  558.         will be "SAMP.PRG".
  559.  
  560.  
  561.         Wildcarding also applies to directories.  If the IN command specifies
  562.         "\TEMP\*.VER" all "VER" files, in the TEMP directory, will be
  563.         processed.  If the OUT command is "TEMP2\*.TMP", any input file will
  564.         be create a "TMP" file in the TEMP2 directory.
  565.  
  566.  
  567.         In our last example, we typed in our conditional parameters using the
  568.         PAR command.  But any dVERSION command can be stored in a dVERSION
  569.         parameter file.  Type:
  570.  
  571.  
  572.              PARMS PARMS
  573.  
  574.  
  575.         and press [Enter].  The parameter file "PARMS" is read, and all
  576.         dVERSION commands within it, are executed.
  577.  
  578.         Suggestion:  Create a parameter file for each of your clients.  That
  579.         way, many clients can share a common set of source code.  When you
  580.         want to test a client's modifications, simply run dVERSION and use
  581.         that client's parameter file.
  582.  
  583.  
  584.  
  585.  
  586.  
  587.  
  588.  
  589.  
  590.  
  591.                                      - Page 9 -
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598.  
  599.                                  Advanced Techniques
  600.  
  601.  
  602.  
  603.                                     Command Line
  604.  
  605.  
  606.  
  607.  
  608.         Perhaps the most timesaving feature added to dVERSION v2.0 is the
  609.         command line mode.  Example, at the DOS prompt, type:
  610.  
  611.  
  612.              DVER *.VER *.PRG PARMS
  613.  
  614.  
  615.         and press [Enter].  At the DOS prompt, you may specify an input file,
  616.         an output file, and a parameter file.  If you specify all three,
  617.         conversion begins immediately.  When all files are converted, you are
  618.         returned to the DOS prompt.
  619.  
  620.         In each sample session, we used only a few dVERSION commands and a
  621.         few dVERSION reserved words.  To use the more advanced dVERSION
  622.         features, you will need to read the reference section carefully.
  623.         Also look at the sample output section for advanced features.  The
  624.         more you experiment with dVERSION, the easier it will become to use.
  625.  
  626.  
  627.                                       Automated
  628.  
  629.  
  630.  
  631.  
  632.         To remain compatible with batch files prior to dVERSION v2.0, you may
  633.         still type:
  634.  
  635.  
  636.              DVER AUTOMATED
  637.  
  638.  
  639.         at the DOS prompt.  All AUTOMATED does is disable testing for the
  640.         escape key, during a conversion.
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.  
  656.  
  657.                                      - Page 10 -
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664.  
  665.                              dVERSION Reference Section
  666.  
  667.  
  668.                               Part I/ dVERSION Commands
  669.  
  670.  
  671.         The following is a summary of all dVERSION commands:
  672.  
  673.         BLK ON               - leading blanks are to be removed from output
  674.                                  code
  675.         CLEAR                - reset all commands to their defaults
  676.         CLS                  - clear screen and home cursor
  677.         HELP topic           - displays a specified topic from the help file
  678.         HLP filespec         - filespec is the dVERSION help file
  679.         IN filespec          - filespec is the dVERSION input file
  680.         LIST LPT2            - send all source code to printer LPT2
  681.         OUT filespec         - filespec is the dVERSION output file
  682.         PAR word             - specifies word as a conditional translating
  683.                                  parameter
  684.         PARMS filespec       - filespec is the dVERSION parameter file
  685.         PMT .                - sets the dVERSION prompt character to "."
  686.         QUIT                 - exit dVERSION and enter DOS
  687.         REM ON               - remarks are to be removed from output code
  688.         REMOVE ON            - remove all trace of specified parameters
  689.         RUN                  - starts program processing
  690.         SUF #                - sets the dVERSION reserved word suffix to "#"
  691.         SYSTEM               - displays the current directory
  692.  
  693.  
  694.         These commands set up the parameters necessary to translate code.
  695.         They may be typed in Upper/Lowercase, and may be specified in any
  696.         order.
  697.  
  698.  
  699.                                      BLK Command
  700.  
  701.  
  702.         SYNTAX:  BLK [flag]
  703.  
  704.         PARAMETERS:
  705.         flag           -    optional, ON or OFF
  706.  
  707.         DESCRIPTION:  Sets the option to remove leading blanks from output
  708.         code.  If no flag is specified, the current status is displayed.  The
  709.         default is OFF.
  710.  
  711.  
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.  
  722.  
  723.                                      - Page 11 -
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.                              dVERSION Reference Section
  732.  
  733.  
  734.                                     CLEAR Command
  735.  
  736.  
  737.         SYNTAX:  CLEAR [command]
  738.  
  739.         PARAMETERS:
  740.         command        -    any dVERSION command
  741.  
  742.         DESCRIPTION:  Sets the specified dVERSION command to it's default
  743.         value.  If command is not specified, all commands are reset to their
  744.         defaults.
  745.  
  746.  
  747.                                      CLS Command
  748.  
  749.  
  750.         SYNTAX:  CLS
  751.  
  752.         PARAMETERS:  none
  753.  
  754.         DESCRIPTION:  This command clears the screen and homes the cursor.
  755.  
  756.  
  757.                                     HELP Command
  758.  
  759.  
  760.         SYNTAX:  HELP [topic] [topic] ...
  761.                  or
  762.                  ? [topic] [topic] ...
  763.  
  764.         PARAMETERS:
  765.         topic          -    any valid help topic
  766.  
  767.         DESCRIPTION:  The help facility provides the user a means of
  768.         displaying information on certain topics.  The HELP command will open
  769.         a help file and will search for a specified topic.  The ? is a HELP
  770.         extension that will not reopen the help file, but will search for a
  771.         specified topic.
  772.  
  773.         If more than one topic is specified, a search is made until each
  774.         subtopic is found.  If no topics are specified, then the next
  775.         available topic is displayed.  For a summary of topics, type HELP
  776.         TOPICS.
  777.  
  778.  
  779.         EXAMPLE 1:
  780.  
  781.              HELP HELP.COMMAND EXAMPLE
  782.  
  783.         The help file is opened.  A search is made for the topic
  784.         HELP.COMMAND, and then for the subtopic EXAMPLE.  If found, the
  785.         subtopic EXAMPLE is displayed.
  786.  
  787.  
  788.  
  789.                                      - Page 12 -
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796.  
  797.                              dVERSION Reference Section
  798.  
  799.  
  800.         EXAMPLE 2:
  801.  
  802.              HELP HELP
  803.  
  804.         If a topic is less than 5 characters, HELP will search for the first
  805.         topic whose beginning characters match it.  In our case, the subject
  806.         topic is HELP.  A search is made of any topic whose first characters
  807.         match HELP.
  808.  
  809.         Having found HELP, suppose we want to see the HELP EXAMPLE.  We can
  810.         type:
  811.  
  812.              ?EXAMPLE
  813.  
  814.         ? can be used instead of HELP.  It merely indicates that the help
  815.         file need not be closed, and the topic search need not start from the
  816.         beginning of the help file.
  817.  
  818.  
  819.                                      HLP Command
  820.  
  821.  
  822.         SYNTAX:  HLP filespec
  823.  
  824.         PARAMETERS:
  825.         filespec       -    any HELP file on a directory
  826.  
  827.         DESCRIPTION:  Sets the HELP file name.  If no file is specified, the
  828.         current file is displayed.  This command is commonly used to allow
  829.         the HELP file to be stored on a ramdisk drive.  The default is
  830.         DVER.HLP.
  831.  
  832.  
  833.                                      IN Command
  834.  
  835.  
  836.         SYNTAX:  IN [filespec]
  837.  
  838.         PARAMETERS:
  839.         filespec       -    any DOS path\filename.ext
  840.  
  841.         DESCRIPTION:  Sets the input file parameter.  This command specifies
  842.         the dVERSION source file.  Wildcards "*" and "?" are  allowed.  If no
  843.         file is specified, the current input file is displayed.
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855.                                      - Page 13 -
  856.  
  857.  
  858.  
  859.  
  860.  
  861.  
  862.  
  863.                              dVERSION Reference Section
  864.  
  865.  
  866.  
  867.                                     LIST Command
  868.  
  869.  
  870.         SYNTAX:  LIST [flag or port]
  871.  
  872.         PARAMETERS:
  873.         flag           -    optional, ON or OFF
  874.         port           -    any printer port (LPT1, COM1, etc.)
  875.  
  876.         DESCRIPTION:  Sets the option to send all input/include files to the
  877.         printer.  If no flag is specified, the current flag is displayed.  If
  878.         the current flag is on, the port is displayed.  Specifying a port
  879.         sets the flag to ON.  The default is OFF.
  880.  
  881.  
  882.                                      OUT Command
  883.  
  884.  
  885.         SYNTAX:  OUT [filespec]
  886.  
  887.         PARAMETERS:
  888.         filespec       -    any DOS path\filename.ext
  889.  
  890.         DESCRIPTION:  Sets the output file parameter.  This command specifies
  891.         the output file.  If no file is specified, the current output file is
  892.         displayed.  If no file extension is specified, the last known
  893.         extension is assumed.  The default output file is "*.PRG".
  894.  
  895.         Note:  If the IN command has a wildcard, the OUT command's
  896.         filename is ignored (path and file extension are still used).
  897.  
  898.  
  899.                                      PAR Command
  900.  
  901.  
  902.         SYNTAX:  PAR [word or number]
  903.  
  904.         PARAMETERS:
  905.         word           -    any valid dBASE variable
  906.         number         -    number of leading spaces
  907.  
  908.         DESCRIPTION:  Adds [word] to a list of conditional translating
  909.         parameters.  All code specified as conditional upon word will be
  910.         translated.  If no parameter is specified, all parameters currently
  911.         in the list are displayed.  See Conditional Translating.
  912.  
  913.         If [number] is specified (and BLK is OFF), [number] of leading spaces
  914.         will be removed from every statement within each conditional.
  915.  
  916.  
  917.  
  918.  
  919.  
  920.  
  921.                                      - Page 14 -
  922.  
  923.  
  924.  
  925.  
  926.  
  927.  
  928.  
  929.                              dVERSION Reference Section
  930.  
  931.  
  932.                                     PARMS Command
  933.  
  934.  
  935.         SYNTAX:  PARMS filespec
  936.  
  937.         PARAMETERS:
  938.         filespec       -    any DOS path\filename.ext
  939.  
  940.         DESCRIPTION:  This command specifies the parameter file.  The
  941.         parameter file may contain any valid dVERSION command.  Upon
  942.         executing this command, the parameter file is read and each dVERSION
  943.         command is executed.
  944.  
  945.         Note:  Any Leading prompt character is ignored.  See PMT Command.
  946.  
  947.  
  948.  
  949.  
  950.  
  951.                                       PMT Command
  952.  
  953.  
  954.         SYNTAX:  PMT <char>
  955.  
  956.         PARAMETERS:
  957.         <char>         -    optional, a non alphanumeric character
  958.  
  959.         DESCRIPTION:  This command sets the prompt character, recognized in
  960.         source code, as a dVERSION command.  If no character is specified,
  961.         the current prompt character is displayed.  The default is a ".".
  962.  
  963.         Note:  Whatever prompt character you choose, make sure it's the same
  964.         prompt character used throughout your source code.
  965.  
  966.  
  967.                                     QUIT Command
  968.  
  969.  
  970.         SYNTAX:  QUIT
  971.  
  972.         PARAMETERS:  none
  973.  
  974.         DESCRIPTION:  Specifies program exit.  The user is returned to DOS.
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.  
  986.  
  987.                                      - Page 15 -
  988.  
  989.  
  990.  
  991.  
  992.  
  993.  
  994.  
  995.                              dVERSION Reference Section
  996.  
  997.  
  998.                                      REM Command
  999.  
  1000.  
  1001.         SYNTAX:  REM [flag]
  1002.  
  1003.         PARAMETERS:
  1004.              flag      -    optional, ON or OFF
  1005.  
  1006.         DESCRIPTION:  Sets the option to remove all records from dBASE code
  1007.         that begin with the remark character "*".  If no command is
  1008.         specified, the current flag is displayed.  The default for flag is
  1009.         OFF.
  1010.  
  1011.         Note:  Remarks that start with "&&" or "NOTE" are not removed.
  1012.  
  1013.  
  1014.                                    REMOVE Command
  1015.  
  1016.  
  1017.         SYNTAX:  REMOVE [flag]
  1018.  
  1019.         PARAMETERS:
  1020.              flag      -    optional, ON or OFF
  1021.  
  1022.         DESCRIPTION:  Sets the option to remove all trace of parameters,
  1023.         specified by the PAR command, in output code.  When set to ON, all
  1024.         parameters not specified by the PAR command will remain in the output
  1025.         code.  If no command is specified, the current flag is displayed.
  1026.         The default for flag is OFF.
  1027.  
  1028.         Note:  This command allows you to remove parameters, creating a
  1029.                fresh set of dVERSION source code.  dVERSION include files,
  1030.                therefore, are ignored.
  1031.  
  1032.  
  1033.                                      RUN Command
  1034.  
  1035.  
  1036.         SYNTAX:  RUN
  1037.  
  1038.         PARAMETERS:  none
  1039.  
  1040.         DESCRIPTION:  This command merely begins the translation.  This
  1041.         program will read the input file(s), specified by IN, and will create
  1042.         the output file(s), specified by OUT.
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.  
  1052.  
  1053.                                      - Page 16 -
  1054.  
  1055.  
  1056.  
  1057.  
  1058.  
  1059.  
  1060.  
  1061.                              dVERSION Reference Section
  1062.  
  1063.  
  1064.                                      SUF Command
  1065.  
  1066.  
  1067.         SYNTAX:  SUF <char>
  1068.  
  1069.         PARAMETERS:
  1070.         <char>         -    optional, a non alphanumeric character
  1071.  
  1072.         DESCRIPTION:  This command sets the ASCII value for the dVERSION
  1073.         reserved word suffix.  If no character is specified, the current
  1074.         suffix character is displayed.  The default is a "\".
  1075.  
  1076.         Note:  Whatever suffix character you choose, make sure it's the same
  1077.         suffix character used throughout your source code.
  1078.  
  1079.  
  1080.                                    SYSTEM Command
  1081.  
  1082.  
  1083.         SYNTAX:  SYSTEM expression
  1084.  
  1085.         PARAMETERS:
  1086.         expression     -    any DOS command
  1087.  
  1088.         DESCRIPTION:  Allows user access to DOS.  If no expression is
  1089.         specified, the current directory is displayed.
  1090.  
  1091.  
  1092.         Note:  The expression parameter may or may not work for your DOS.  If
  1093.         it does not work, the expression parameter will be ignored.
  1094.  
  1095.  
  1096.  
  1097.  
  1098.  
  1099.  
  1100.  
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.  
  1118.  
  1119.                                      - Page 17 -
  1120.  
  1121.  
  1122.  
  1123.  
  1124.  
  1125.  
  1126.  
  1127.                              dVERSION Reference Section
  1128.  
  1129.  
  1130.                           Part II/ dVERSION Reserved Words
  1131.  
  1132.  
  1133.         The following functions are available in dVERSION code:
  1134.  
  1135.  
  1136.         IF\                 END\           INCLUDE\
  1137.         Remarks             Macros
  1138.  
  1139.  
  1140.                              - Conditional Translating -
  1141.  
  1142.  
  1143.         SYNTAX:  IF\ [NOT] word [, word] [, word] ...
  1144.                  END\
  1145.  
  1146.         PARAMETERS:
  1147.         NOT            -    optional, if parameter word is NOT
  1148.                             specified, then condition is true
  1149.         word           -    Any valid dBASE variable phrase
  1150.  
  1151.         DESCRIPTION:  Conditional translating is a facility that allows the
  1152.         programmer to specify certain sections of code to be translated or to
  1153.         be ignored.  When dBASE code is between the dVERSION reserved words
  1154.         IF\ or END\, it is assumed to be within conditional translating.
  1155.  
  1156.         When the dVERSION reserved word IF\ is found, a comparison is made
  1157.         between all word parameter(s) and the list of parameters specified by
  1158.         the PAR command.  If any match, all following code will be included
  1159.         in translation.  If none match, all following code is ignored in
  1160.         translation.
  1161.  
  1162.         When the reserved word END\ is found, conditional translating is
  1163.         reset to the status before the last IF\.  Any following code is
  1164.         translated as standard dBASE code until another IF\ or END\ is found.
  1165.  
  1166.  
  1167.                                     - INCLUDE\ -
  1168.  
  1169.  
  1170.         SYNTAX:  INCLUDE\ filespec
  1171.  
  1172.         PARAMETERS:
  1173.         filespec       -    any DOS path\filename.ext
  1174.  
  1175.         DESCRIPTION:  When the first statement in a program line is a
  1176.         INCLUDE, it is assumed to be an dVERSION reserved word.  If the file
  1177.         is found, it is opened and it's code included.
  1178.  
  1179.  
  1180.  
  1181.  
  1182.  
  1183.  
  1184.  
  1185.                                      - Page 18 -
  1186.  
  1187.  
  1188.  
  1189.  
  1190.  
  1191.  
  1192.  
  1193.                              dVERSION Reference Section
  1194.  
  1195.  
  1196.                                      - Remarks -
  1197.  
  1198.  
  1199.         SYNTAX:  *anything...
  1200.  
  1201.         PARAMETERS:  none
  1202.  
  1203.         DESCRIPTION:  When the REM flag is set (see REM command), all source
  1204.         code records starting with an asterisk are ignored and are not sent
  1205.         to the output file.
  1206.  
  1207.         Note:  There is one exception.  If the REMOVE flag is set (see REMOVE
  1208.         command), then any remark beginning with (** ' ), and containing the
  1209.         uppercase portion of any specified parameter (see PAR command) will
  1210.         not be sent to the output file.
  1211.  
  1212.  
  1213.                                      - Macros -
  1214.  
  1215.  
  1216.         SYNTAX: .command
  1217.  
  1218.         PARAMETERS:
  1219.  
  1220.         DESCRIPTION:  Macros are dVERSION commands contained in source code.
  1221.         All macros begin with the dVERSION prompt character (see PMT
  1222.         command).  The default is a period.  The command following the period
  1223.         may be any dVERSION command (REM, BLK, PAR, etc.).  In this way, the
  1224.         Macro facility provides a way of setting default values without using
  1225.         batch files.
  1226.  
  1227.  
  1228.  
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.  
  1249.  
  1250.  
  1251.                                      - Page 19 -
  1252.  
  1253.  
  1254.  
  1255.  
  1256.  
  1257.  
  1258.  
  1259.                              dVERSION Reference Section
  1260.  
  1261.  
  1262.                           Part III/ dVERSION Error Messages
  1263.  
  1264.  
  1265.         The following is a brief description of dVERSION command errors:
  1266.  
  1267.         ** Invalid Command
  1268.              Either the command was not found, or the command was incorrectly
  1269.              typed.  Check your spelling, and retype.
  1270.  
  1271.         ** Topic Not Found
  1272.  
  1273.         ** End of Topic (or Subtopic)
  1274.              Merely indicates that the HELP utility found all the information
  1275.              it can on a given topic.
  1276.  
  1277.         ** File Name Conflict
  1278.              dVERSION cannot continue runtime execution until the IN and the
  1279.              OUT commands are correctly specified.  IN also cannot equal OUT.
  1280.  
  1281.         ** INCLUDE filespec cannot be opened
  1282.              The maximum of 15 files have been opened at one time.
  1283.  
  1284.         ** Device not available, Error#25
  1285.              Printer is not online.
  1286.  
  1287.         ** File Not Found, Error#53
  1288.  
  1289.         ** Bad File Name, Error#64
  1290.  
  1291.         ** Syntax Error, Error#
  1292.  
  1293.         ** Disk Error, Error#
  1294.              Refer to your Disk owners manual, or to your quick basic
  1295.              reference guide.
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.  
  1309.  
  1310.  
  1311.  
  1312.  
  1313.  
  1314.  
  1315.  
  1316.  
  1317.                                      - Page 20 -
  1318.  
  1319.  
  1320.  
  1321.  
  1322.  
  1323.  
  1324.  
  1325.                              dVERSION Reference Section
  1326.  
  1327.  
  1328.                            Part IV/ dVERSION Sample Output
  1329.  
  1330.  
  1331.         The following is a sample session, the sample input files, and the
  1332.         output file produced:
  1333.  
  1334.         DVER
  1335.         IN SAMPLE.VER
  1336.         OUT SAMPLE.PRG
  1337.         PAR DOS
  1338.         REM ON
  1339.         BLK ON
  1340.         RUN
  1341.         QUIT
  1342.  
  1343.  
  1344.                              dVERSION Sample Input File
  1345.  
  1346.  
  1347.         NOTE PROGRAM MAL.PRG 03.05.01
  1348.         NOTE PROGRAMMER D. ALLEN
  1349.         NOTE CREATED AUG 30, 1987
  1350.         NOTE UPDATED FEB 12, 1993
  1351.         NOTE COPYRIGHT(C) 1987
  1352.         *
  1353.         *     THE PROCEDURE IS A STRIPPED DOWN VERSION OF MAL.PRG, THE
  1354.         *     STARTUP PROCEDURE OF THE DMAIL4 APPLICATION.
  1355.         *
  1356.  
  1357.         CLEAR ALL
  1358.         CLOSE ALL
  1359.         SET RESOURCE ON
  1360.         SET SAFETY OFF
  1361.         SET TALK OFF
  1362.  
  1363.         SET PROCEDURE TO SCRPROC
  1364.  
  1365.         IF\ DOS
  1366.           SET BORDER TO DOUBLE
  1367.           SET CLOCK TO 00,SCOLS()-11
  1368.           SET CLOCK ON
  1369.           SET SHADOWS ON
  1370.           = SYS(2008,"I",2)
  1371.           = SYS(2008,"O",0)
  1372.           = INSMODE(.F.)
  1373.         END\
  1374.         IF\ WINDOWS
  1375.           DO COLORSET WITH "FOXDEF"
  1376.           CLEAR
  1377.           SET CLOCK ON
  1378.           SET CLOCK STATUS
  1379.           SET STATUS BAR ON
  1380.         END\
  1381.  
  1382.  
  1383.                                      - Page 21 -
  1384.  
  1385.  
  1386.  
  1387.  
  1388.  
  1389.  
  1390.  
  1391.                              dVERSION Reference Section
  1392.  
  1393.  
  1394.         INCLUDE\ SAMPLE2.VER
  1395.  
  1396.         *
  1397.         *    MAIN ROUTINE
  1398.         *
  1399.         ACTIVATE SCREEN
  1400.         @ 1,0 CLEAR
  1401.         DO CTR WITH 1, IIF(bMULT,"Multi-user ","")+"Mailing List, Version
  1402.         03.05.01"
  1403.         DO CTR WITH 2, "(c) 1987 Dennis Allen, All rights reserved"
  1404.         DO WHILE .T.
  1405.  
  1406.           ON ERROR DO FOXERR WITH ERROR(), MESSAGE(), MESSAGE(1), PROGRAM(),
  1407.         LINENO(), SYS(16)
  1408.  
  1409.           DO WINDOW WITH "MAL", " M A I N   M E N U "
  1410.           cCHOICES = "EPSU"
  1411.           nCOL = ROUND(WCOLS()/2,0) - 19
  1412.           @  1,nCOL PROMPT " [\<E] - Edit  Mailing List "
  1413.           @  3,nCOL PROMPT " [\<P] - Print Mailing List "
  1414.           @  7,nCOL PROMPT " [\<S] - System Setup (Query)"
  1415.           @  9,nCOL PROMPT " [\<U] - Utilities"
  1416.           @ 13,nCOL PROMPT " [\<Q] - Quit this program"
  1417.           cCHOICES = cCHOICES+"Q"
  1418.           MENU TO mCHOICE
  1419.           cCHOICE = IIF(mCHOICE > 0,SUBSTR(cCHOICES,mCHOICE,1),"")
  1420.           DO DIALOG WITH .F.
  1421.           DO CASE
  1422.           CASE cCHOICE = "E"
  1423.             DO MALED
  1424.           CASE cCHOICE = "P"
  1425.             DO MALPR
  1426.           CASE cCHOICE = "S"
  1427.             DO MALSYS
  1428.           CASE cCHOICE = "U"
  1429.             DO MALUT
  1430.           CASE cCHOICE = "Q"
  1431.             IF YESNO(" Are you Sure (Y or N) ?  ","N") = "N"
  1432.               LOOP
  1433.             ENDIF
  1434.             DELETE FILE (PROGRAM()+".MEM")
  1435.             IF SYS(16,1) = SYS(16)
  1436.               QUIT
  1437.             ENDIF
  1438.             EXIT
  1439.           ENDCASE
  1440.         ENDDO
  1441.         RETURN
  1442.  
  1443.  
  1444.  
  1445.  
  1446.  
  1447.  
  1448.  
  1449.                                      - Page 22 -
  1450.  
  1451.  
  1452.  
  1453.  
  1454.  
  1455.  
  1456.  
  1457.                              dVERSION Reference Section
  1458.  
  1459.  
  1460.  
  1461.  
  1462.                             dVERSION Sample Include File
  1463.  
  1464.  
  1465.         IF\ DOS
  1466.           IF DATE() = {01/01/1980}
  1467.             ??CHR(7)+CHR(7)
  1468.             TEXT
  1469.  
  1470.           The system date has not been set.  Use the operating system DATE
  1471.         command
  1472.           to set today's date.  At the operating system prompt, type a
  1473.         command of
  1474.           the form:
  1475.  
  1476.                               DATE 07.07.87
  1477.  
  1478.         ... and press the RETURN key, which may be marked ENTER or --+.  The
  1479.           above command would set the date to July 7, 1987.  Once you have
  1480.         done
  1481.           this you can run this program again.
  1482.  
  1483.             ENDTEXT
  1484.             @ 23,0
  1485.             WAIT "Press any key to return to the operating system . . . "
  1486.             QUIT
  1487.           ENDIF
  1488.         END\
  1489.  
  1490.         IF DISKSPACE() < 1474560
  1491.           ??CHR(7)+CHR(7)
  1492.           TEXT
  1493.           Diskspace too small for application...
  1494.           ENDTEXT
  1495.           @ 23,0
  1496.           WAIT "Press any key to return to the operating system . . . "
  1497.           QUIT
  1498.         ENDIF
  1499.  
  1500.         IF !SYS(2000,PROGRAM()+".MEM") == ""
  1501.           ??CHR(7)+CHR(7)
  1502.           TEXT
  1503.           Please remember to exit this application before turning off the
  1504.         computer...
  1505.           ENDTEXT
  1506.           @ 23,0
  1507.           WAIT "Press any key to continue . . . "
  1508.         ENDIF
  1509.         SAVE TO (PROGRAM())
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.                                      - Page 23 -
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.                              dVERSION Reference Section
  1524.  
  1525.  
  1526.                              dVERSION Sample Output File
  1527.  
  1528.  
  1529.         NOTE PROGRAM MAL.PRG 03.05.01
  1530.         NOTE PROGRAMMER D. ALLEN
  1531.         NOTE CREATED AUG 30, 1987
  1532.         NOTE UPDATED FEB 12, 1993
  1533.         NOTE COPYRIGHT(C) 1987
  1534.         CLEAR ALL
  1535.         CLOSE ALL
  1536.         SET RESOURCE ON
  1537.         SET SAFETY OFF
  1538.         SET TALK OFF
  1539.         SET PROCEDURE TO SCRPROC
  1540.         SET BORDER TO DOUBLE
  1541.         SET CLOCK TO 00,SCOLS()-11
  1542.         SET CLOCK ON
  1543.         SET SHADOWS ON
  1544.         = SYS(2008,"I",2)
  1545.         = SYS(2008,"O",0)
  1546.         = INSMODE(.F.)
  1547.         IF DATE() = {01/01/1980}
  1548.         ??CHR(7)+CHR(7)
  1549.         TEXT
  1550.  
  1551.           The system date has not been set.  Use the operating system DATE
  1552.         command
  1553.           to set today's date.  At the operating system prompt, type a
  1554.         command of
  1555.           the form:
  1556.  
  1557.                               DATE 07.07.87
  1558.  
  1559.           ... and press the RETURN key, which may be marked ENTER or --+.
  1560.         The
  1561.           above command would set the date to July 7, 1987.  Once you have
  1562.         done
  1563.           this you can run this program again.
  1564.  
  1565.         ENDTEXT
  1566.         @ 23,0
  1567.         WAIT "Press any key to return to the operating system . . . "
  1568.         QUIT
  1569.         ENDIF
  1570.         IF DISKSPACE() < 1474560
  1571.         ??CHR(7)+CHR(7)
  1572.         TEXT
  1573.           Diskspace too small for application...
  1574.         ENDTEXT
  1575.         @ 23,0
  1576.         WAIT "Press any key to return to the operating system . . . "
  1577.         QUIT
  1578.         ENDIF
  1579.         IF !SYS(2000,PROGRAM()+".MEM") == ""
  1580.  
  1581.                                      - Page 24 -
  1582.  
  1583.  
  1584.  
  1585.  
  1586.  
  1587.  
  1588.  
  1589.                              dVERSION Reference Section
  1590.  
  1591.  
  1592.         ??CHR(7)+CHR(7)
  1593.         TEXT
  1594.           Please remember to exit this application before turning off the
  1595.         computer...
  1596.         ENDTEXT
  1597.         @ 23,0
  1598.         WAIT "Press any key to continue . . . "
  1599.         ENDIF
  1600.         SAVE TO (PROGRAM())
  1601.         ACTIVATE SCREEN
  1602.         @ 1,0 CLEAR
  1603.         DO CTR WITH 1, IIF(bMULT,"Multi-user ","")+"Mailing List, Version
  1604.         03.05.01"
  1605.         DO CTR WITH 2, "(c) 1987 Dennis Allen, All rights reserved"
  1606.         DO WHILE .T.
  1607.         ON ERROR DO FOXERR WITH ERROR(), MESSAGE(), MESSAGE(1), PROGRAM(),
  1608.         LINENO(), SYS(16)
  1609.         DO WINDOW WITH "MAL", " M A I N   M E N U "
  1610.         cCHOICES = "EPSU"
  1611.         nCOL = ROUND(WCOLS()/2,0) - 19
  1612.         @  1,nCOL PROMPT " [\<E] - Edit  Mailing List "
  1613.         @  3,nCOL PROMPT " [\<P] - Print Mailing List "
  1614.         @  7,nCOL PROMPT " [\<S] - System Setup (Query)"
  1615.         @  9,nCOL PROMPT " [\<U] - Utilities"
  1616.         @ 13,nCOL PROMPT " [\<Q] - Quit this program"
  1617.         cCHOICES = cCHOICES+"Q"
  1618.         MENU TO mCHOICE
  1619.         cCHOICE = IIF(mCHOICE > 0,SUBSTR(cCHOICES,mCHOICE,1),"")
  1620.         DO DIALOG WITH .F.
  1621.         DO CASE
  1622.         CASE cCHOICE = "E"
  1623.         DO MALED
  1624.         CASE cCHOICE = "P"
  1625.         DO MALPR
  1626.         CASE cCHOICE = "S"
  1627.         DO MALSYS
  1628.         CASE cCHOICE = "U"
  1629.         DO MALUT
  1630.         CASE cCHOICE = "Q"
  1631.         IF YESNO(" Are you Sure (Y or N) ?  ","N") = "N"
  1632.         LOOP
  1633.         ENDIF
  1634.         DELETE FILE (PROGRAM()+".MEM")
  1635.         IF SYS(16,1) = SYS(16)
  1636.         QUIT
  1637.         ENDIF
  1638.         EXIT
  1639.         ENDCASE
  1640.         ENDDO
  1641.         RETURN
  1642.  
  1643.  
  1644.  
  1645.  
  1646.  
  1647.                                      - Page 25 -
  1648.  
  1649.  
  1650.  
  1651.  
  1652.  
  1653.  
  1654.  
  1655.                                Appendix A/ Data Files
  1656.  
  1657.  
  1658.         The first thing you should do is make a backup copy of your dVERSION
  1659.         disk IMMEDIATELY.  There are many ways to backup your disk, so check
  1660.         your DOS owner's manual for details.
  1661.  
  1662.         The following programs are included on your Data Disk:
  1663.  
  1664.              DVER.EXE            DVER.HLP            DVER.MAN
  1665.              MANUAL.BAT          SAMPLE.VER          SAMPLE2.VER
  1666.  
  1667.         DVER.EXE is the dVERSION BASIC compiled program.  DVER.HLP is the
  1668.         help file.  It contains on-line instructions on how to use dVERSION.
  1669.  
  1670.         DVER.MAN is the dVERSION manual.  To print the manual, type MANUAL at
  1671.         the DOS prompt.
  1672.  
  1673.  
  1674.  
  1675.  
  1676.  
  1677.  
  1678.  
  1679.  
  1680.  
  1681.  
  1682.  
  1683.  
  1684.  
  1685.  
  1686.  
  1687.  
  1688.  
  1689.  
  1690.  
  1691.  
  1692.  
  1693.  
  1694.  
  1695.  
  1696.  
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.  
  1704.  
  1705.  
  1706.  
  1707.  
  1708.  
  1709.  
  1710.  
  1711.  
  1712.  
  1713.                                      - Page 26 -
  1714.  
  1715.  
  1716.  
  1717.  
  1718.  
  1719.  
  1720.  
  1721.                            Appendix B/ dVERSION Standards
  1722.  
  1723.  
  1724.         The following is a set of guidelines for creating dVERSION files:
  1725.  
  1726.         1.   File names should use the following file extensions:
  1727.              a) VER for a dVERSION input file
  1728.              b) PRG for a dVERSION output file
  1729.              c) HLP for a dVERSION HELP file
  1730.  
  1731.         2.   A program should begin with the following remarks:
  1732.              a) * program name
  1733.              b) * programmer's name
  1734.              c) * date created
  1735.              d) * date updated
  1736.  
  1737.         3.   A program should also include the following documentation:
  1738.              a) briefly state the purpose of the program
  1739.              b) state all Input/Processing/Output of the program
  1740.              c) include a variable dictionary
  1741.  
  1742.         4.   All procedures should have the following documentation:
  1743.              a) state the purpose of the procedure
  1744.              b) state any flags set
  1745.              c) state the name of the calling procedure, if any
  1746.              d) state the name of the procedure to return
  1747.              e) include parameter, public, and variable dictionaries
  1748.  
  1749.         5.   All programmer documentation should begin with an asterisk.
  1750.  
  1751.         6.   Any modification to dBASE code should be contained within a
  1752.              conditional.  All conditionals should be documented.  The
  1753.              following is an example remark for the conditional UNITMS:
  1754.  
  1755.              ** ' 01/01/89 DA Handling UNITMS   **
  1756.  
  1757.         7.   All dVERSION reserved words should be in uppercase characters.
  1758.  
  1759.         8.   Do not use dVERSION reserved words as variables.
  1760.  
  1761.         9.   Program lines within the body of an "IF\ END\" conditional block
  1762.              should be indented 2 spaces past the starting column of the
  1763.              "IF\".  The "END\" starts in the same column as the "IF\".  Use
  1764.              the dVERSION command "PAR 2" to keep conditional code lined up.
  1765.  
  1766.         10.  If a program line is continued, the continuation line should be
  1767.              indented 2 spaces beyond the original line column.
  1768.  
  1769.  
  1770.  
  1771.  
  1772.  
  1773.  
  1774.  
  1775.  
  1776.  
  1777.  
  1778.  
  1779.                                      - Page 27 -
  1780.  
  1781.  
  1782.  
  1783.  
  1784.  
  1785.  
  1786.  
  1787.                                       GLOSSARY
  1788.  
  1789.  
  1790.         Arrow Keys  -  Equivalent to cursor keys.  Those keys on the keyboard
  1791.              labeled with arrows.
  1792.  
  1793.         ASCII  -  American Standard Code for Information Interchange.  A
  1794.              standard 7 bit code used to represent data.
  1795.  
  1796.         Batch File  -  A file containing multiple DOS commands.  These
  1797.              commands are executed by DOS, one at a time, as if typed by the
  1798.              user.
  1799.  
  1800.         Boolean  -  The logical comparison between two values.  Common
  1801.              boolean operators are: OR, AND, and NOT.
  1802.  
  1803.         Byte  -  A unit of information.  In text form, equivalent to an ASCII
  1804.              character.
  1805.  
  1806.         COBOL  -  COmmon Business Oriented Language.
  1807.  
  1808.         Code  -  Program code.  Another way of saying program instructions.
  1809.  
  1810.         Compiler  -  A program that converts program code from one form to
  1811.              another, usually more primitive, form.  The converted code is
  1812.              then ready for execution.
  1813.  
  1814.         Conditional Translation  -  Derived from FORTRAN.  A process where
  1815.              code is compiled/translated if certain parameters are met.
  1816.  
  1817.         Cursor  -  A flashing character on the screen.  It indicates where
  1818.              typed text will be next placed.
  1819.  
  1820.         Cursor Keys  -  Equivalent to arrow keys.  Those keys on the keyboard
  1821.              labeled with arrows.
  1822.  
  1823.         dBASE  -  Popular database management program.  The software package
  1824.              dBASE III+ is an interpreter for dBASE code.
  1825.  
  1826.         Disk  -  A unit where information is stored.  There are two major
  1827.              types: hard disk, and floppy disk.
  1828.  
  1829.         Disk Error  -  An error occurring when a program is unable to read or
  1830.              write properly to a disk.
  1831.  
  1832.         Diskspace  -  A unit of how much room is available on a drive.  It is
  1833.              usually measured in bytes.
  1834.  
  1835.         DOS  -  Disk Operating System.
  1836.  
  1837.         Executable Code  -  What a translator or compiler creates from source
  1838.              code.
  1839.  
  1840.         Expression  -  A general Term for Data.  There are four types of
  1841.              expressions:  Numeric, String, Relational, and Logical.
  1842.  
  1843.  
  1844.  
  1845.                                      - Page 28 -
  1846.  
  1847.  
  1848.  
  1849.  
  1850.  
  1851.  
  1852.  
  1853.                                       GLOSSARY
  1854.  
  1855.  
  1856.         Filespec  -  any DOS filename.ext including catalog names, passwords,
  1857.              etc.
  1858.  
  1859.         Floppy Disk  -  A self contained unit where information is stored.
  1860.              Depending on the type, floppy disks are easily transportable.
  1861.              Sometimes called a diskette.
  1862.  
  1863.         Foxbase  -   A dBASE III plus compiler.
  1864.  
  1865.         Foxpro  -   A dBASE IV compiler.
  1866.  
  1867.         Hard Disk  -  A self contained unit where information is stored.
  1868.              Usually not removable.
  1869.  
  1870.         HELP  -  A facility that provides on-line assistance in the use of a
  1871.              given program.
  1872.  
  1873.         Highlight  -  A form of a cursor, where an entire field is considered
  1874.              the cursor.
  1875.  
  1876.         Interpreter  -  A program that executes program code.  Whereas a
  1877.              compiler translates program code to executable code, an
  1878.              interpreter translates a single line of program code before
  1879.              executing it.
  1880.  
  1881.         MS-DOS  -  Microsoft Disk Operating System.
  1882.  
  1883.         Multi-user  -  When more one than one person is capable of
  1884.              accessing/updating the same database at the same time.
  1885.  
  1886.         Reserved word  -  What an interpreter/compiler recognizes as a
  1887.              language command.
  1888.  
  1889.         Runtime  -  A period of time when a program is executing, compiling,
  1890.              or translating.
  1891.  
  1892.         Sideways  -  A Utility that will print text up and down instead of
  1893.              across the paper.
  1894.  
  1895.         Source Code  -  What a translator/compiler takes in as input.
  1896.  
  1897.         Syntax  -  The rules for the arrangement of statements in a
  1898.              programming language.
  1899.  
  1900.         Translator  -  A program that converts program code from one form to
  1901.              another form.
  1902.  
  1903.         Variable Phrase  -  A variable name beginning with a letter (A-Z),
  1904.              and consisting of letters, digits, or underlines (A-Z,0-9,_).  A
  1905.              dBASE variable may have up to 10 characters.
  1906.  
  1907.  
  1908.  
  1909.  
  1910.  
  1911.                                      - Page 29 -
  1912.  
  1913.  
  1914.  
  1915.  
  1916.  
  1917.  
  1918.  
  1919.                                         Index
  1920.  
  1921.  
  1922.         - Conditional Translating -  18
  1923.         - INCLUDE\ -  18
  1924.         - Macros -  19
  1925.         - Remarks -  19
  1926.         Advanced Techniques  9
  1927.         Appendix A/ Data Files  26
  1928.         Appendix B/ dVERSION Standards  27
  1929.         Arrow Keys  28
  1930.         ASCII  28
  1931.         Automated  10
  1932.         Batch File  28
  1933.         BLK Command  11
  1934.         Boolean  28
  1935.         Byte  28
  1936.         CLEAR Command  12
  1937.         CLS Command  12
  1938.         COBOL  28
  1939.         Code  28
  1940.         Command Line  10
  1941.         Compiler  28
  1942.         Conditional Translating  7
  1943.         Conditional translation  4, 28
  1944.         Copyright/License/Warranty  2
  1945.         Cursor  28
  1946.         Cursor Keys  28
  1947.         DBASE  1, 28
  1948.         Disk  28
  1949.         Disk Error  28
  1950.         Diskspace  28
  1951.         DOS  28
  1952.         DVER  6, 9
  1953.         DVER.EXE  26
  1954.         DVER.MAN  26
  1955.         DVERSION  1
  1956.         DVERSION Reference Section  11
  1957.         DVERSION Sample Include File  23
  1958.         DVERSION Sample Input File  21
  1959.         DVERSION Sample Output File  24
  1960.         Executable Code  28
  1961.         Expression  28
  1962.         Filespec  29
  1963.         Floppy Disk  29
  1964.         Foxbase  29
  1965.         Foxpro  29
  1966.         Getting Started  6
  1967.         GLOSSARY  28
  1968.         Hard Disk  29
  1969.         HELP  29
  1970.         HELP Command  12
  1971.         Highlight  29
  1972.         HLP Command  13
  1973.         IN Command  13
  1974.         INCLUDE  1
  1975.         INCLUDE\  8
  1976.  
  1977.                                      - Page 30 -
  1978.  
  1979.  
  1980.  
  1981.  
  1982.  
  1983.  
  1984.  
  1985.                                         Index
  1986.  
  1987.  
  1988.         Index  30
  1989.         Interpreter  29
  1990.         Introduction  4
  1991.         LIST Command  14
  1992.         MS-DOS  29
  1993.         Multi-user  29
  1994.         Notation Conventions  5
  1995.         OUT Command  14
  1996.         Output code  4
  1997.         PAR Command  14
  1998.         PARMS Command  15
  1999.         Part I/ dVERSION Commands  11
  2000.         Part II/ dVERSION Reserved Words  18
  2001.         Part III/ dVERSION Error Messages  20
  2002.         Part IV/ dVERSION Sample Output  21
  2003.         PMT Command  15
  2004.         Preface  1
  2005.         QUIT Command  15
  2006.         REM Command  16
  2007.         Remarks  8
  2008.         REMOVE Command  16
  2009.         Reserved word  29
  2010.         RUN Command  16
  2011.         Runtime  29
  2012.         Sideways  29
  2013.         Source code  4, 29
  2014.         SUF Command  17
  2015.         Syntax  29
  2016.         SYSTEM Command  17
  2017.         TABLE OF CONTENTS  3
  2018.         Translating dVERSION code  7
  2019.         Translator  29
  2020.         Variable Phrase  29
  2021.         Wildcard  9
  2022.  
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.  
  2029.  
  2030.  
  2031.  
  2032.  
  2033.  
  2034.  
  2035.  
  2036.  
  2037.  
  2038.  
  2039.  
  2040.  
  2041.  
  2042.  
  2043.                                      - Page 31 -
  2044.  
  2045.  
  2046.  
  2047.